<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <meta http-equiv="content-type" content="text/html; charset=utf-8" />
  <link rel="stylesheet" href="content/main.css" type="text/css" />
  <title>CPAN::Web : Intro</title>
</head>
<body>
  <div id="wrapper">
    <div id="header">
      <div id="banner"><a href="index.html"><img src="content/banner.png" alt="Making CPAN installs easy" /></a></div>
      <div id="logo"><img src="content/banner_right.png" alt="CPAN::Web : Making CPAN installs easy" /></div>
    </div>
    <div class="flush">&nbsp;</div>
    <div id="content">
      <div id="columnLeft">
        <h3>I want to</h3>
        <ul class="nav">
          <li><a href="search.pl">Search</a></li>
          <li><a href="know-more.html">Know more</a></li>
          <li><a href="help-out.html">Contribute</a></li>
        </ul>
      </div>
      <div id="columnRight">
        <div class="contentLeft">
          <h2>What is CPAN::Web?</h2>
          <p>CPAN::Web is a web application that enables installing CPAN modules to your server
             from a web browser instead from the command line.</p>
          <h2>What does it require?</h2>
          <p>You need to have the following modules installed:</p>
          <ul>
            <li><a href="http://search.cpan.org/~kane/CPANPLUS-0.84/lib/CPANPLUS.pm">CPANPLUS</a></li>
            <li><a href="http://search.cpan.org/~apeiron/local-lib-1.001000/lib/local/lib.pm">local::lib</a></li>
          </ul>
          <p>You also need:</p>
          <ul>
            <li>These directores to be writeable by your web server:
              <ul>
                <li>~/perl5</li>
                <li>.cpanplus directory (usually in ~/.cpanplus)</li>
              </ul>
            </li>
            <li>A running web server (if you can see this page you probably already have that)</li>
          </ul>
        </div>
        <div class="contentRight">
          <h2>Be careful!</h2>
          <p>CPAN::Web is something to be careful with. It lets you install modules on your server.
            Anything that installs anything on your server is potentially dangerous. You should therefore
            make sure that you don't make this application available to everyone. I suggest using 
            Basic or Digest Authentication to stop unauthorized users accessing it. Security is your
            responsibility.
          </p>
          <h2>Getting started</h2>
          <p>Do a <a href="search.pl">search</a> and it should just work. Enjoy!</p>
        </div>
      </div>
      <div class="flush">&nbsp;</div>
      <div class="footer">
        <p>CPAN::Web is an open source applicaton designed to make installing CPAN modules easy.
        &copy; 2008 Robbie Bow. Distributed as is with no warranty.
        This work is licenced under a <a rel="license" href="http://creativecommons.org/licenses/by/2.0/uk/">Creative Commons Licence</a>.</p>
      </div>
    </div>
  </div>
</body>
</html>